Multics Technical Bulletin MTB-I^JS 

To: Distribution 
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Date: December 11, 197^ 

Subject: Reportinf^ status from peripheral devices 

Overview 

A new table-driven mechanism is beinr provided to analvze 
the status returned by the lOM for peripheral devices ar.6 to 
report on error conditions found in the status. This rechanisr; 
is designed primarily for those devices v/hich are driven through 
the I/O Interfacer, but it is not limited to such devices. A 
status interpretation table for each different type of peripheral 
device is required. A primitive is provided which is ^^iven the 
nane of the peripheral device, the lOH status, and a Dointer to 
the status interpretation table. This primitive will renort all 
error conditions found in the status via calls to com__err .. The 
primitive will also return 18 bits of information to its caller 
to aid in determining what action should be taken on the basis of 
the status. 

Anal yzi np: termination s tatu s 

When termination status indicatinfr an error is returned by 
the lOM, the following call can be made to analyze the status: 

del- analyze__device_stat_ entry (char (*), ptr, bit (72) 
aligned , bit ( 18) aligned) ; 

call analyze_device_stat__ (devname, tablep, iom_ status, 
flags); 



devname is the name of the device for which status 
has been received. It is used as the first 
argument passed to coR__err__. (Input) 

tablep is a pointer to the status interpretation 

table for the device. See section below for 

a description of the status interpretation 

table format. (Input) 
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iom._ status is the 72 bits of status returned by the lOM. 

(Input) 

flarrs are 18 bits of information designed to aid 

the caller in decidin? how to act on the 
status. Currently, two bits are defined: 
substr (flags, 1, 1) is used to indicate that 
the . I/O operation for which status was 
returned should be re-executed 
unconditionally. substr (fla,?s, 2, 1) will 
cause substr (flaR;s, 1, 1) to be set if the 
initiation bit in the lOM status is on. That 
is, it will force an indication that the I/O 
operation for v;hich status was returned 
should be re-executed only if it failed 
during initiation of the operation. (Output) 



hote that analyze__device__stat_ should not be called with lOH 
status that does not indicate an error condition. An error bit 
is provided for such purposes by the I/O Interfacer. Other users 
should ceternine that ohe or more of the followin.ft fields in the 
lOH status bits are nonzero before callinpc analyze_device_stat_: 
power, major status, lOM central status, lOM channel status, 

Analyzinr; system f_a,ult st atu s 

Certain serious lOM errors do not cause termination status 
to be stored. Instead, they cause an lOM system fault which 
returns IGM system fault status to the user. This condition is 
indicated by an lOM interrupt level of 1. In this case, a 
different call should be made to analyze the status information: 

declare analyze_system_fault___ entry (char (*), bit (72) 
alip:ned ) ; 

call analyze__systen__fault_,_ (devname, iomi _status) : 

( Arguments are as above.) 

-^-ta.Lus Interpret ati on Tabl e 

The status interpretation tables for each device are coded 
in r.exp . Each table consists of a header, and an array of 
substatuses for eacn major status v;hich the device can venerate. 
The I'ormat of the table header is as follows: 

declare 1 stable (15) based (tablep) alifrned , 
2 offset hit (18) unali.^ned , 
2 count fixed bin (17) unalifrned; 
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stable is an array v.'hich contains an elenient for 
each possible major status. 

offset is a relative pointer to the .-structure 
describing; this rriajor status and its possible 
substatuses . If offset is zero, the 
correspondin,f?; major status is not expected 
for this device. 

count is a count of the different substatuses 

expected for this major status. 

Each raajor status and its associated .substatuses are 
described by the follov;ing structure: 

declare 1 sinfo based (sp) aliened, 
2 maj char (2'0 , 
2 sub (count) , 

3 control char (6), 

3 flares bit (18), 

3 desc char (32) ; 

sinfo is the structure. 

n^aj is a description of the najor status, 

sub is an array of substatuses expected for this 

major status. 

control is 6 characters of information describin- the 
substatus bit configuration. Only three 
characters are permitted in the control 
string: "0", "1", and "X". In order for a 
fTiven substatus to match a table entry, each 
■ 0" or "V in the control strin? nust be 
matched by a corresponding '-O" or "1" bit in 
the substatus. Bits corresponding to -X" 
characters are not compared. 

flags are 18 bits of information v;hich can be used 

to determine what action should be taken for 
this status. See above for a description of 
the defined fla,'^ bits. 

desc is a description of the substatus. 
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Status In terpretatio n Tab le Generation Ma cros 

Three macros are provided for the purposes of generatine; a 
status interpretation table for a device. The first of these is 
desip:ned to generate the table header. The other two s-enerate 
the major status and substatus information structures. 

status_table devname, ( control ) 

This macro sets up the table header and defines a seedef so 
that the table can be externally accessed syribolically . It also 
causes the symbols "backup" and "initiate" to be defined as 
400000 octal and 200000 octal respectively. These are used in 
settin;^ the flags. 

devname is the name of the device for which a status 
interpretation table is to be n;enerated. The 
sefTment is p;iven a name of 
devnarae_status__table" . The table header can 
be found at the sep:def 
"devname_status table". 

control is a strin,<^ of 15 numbers seperated by 
commas. A zero indicates that the 
correspondin,*?; major status is not expected 
for this device. A nonzero number indicates 
that the correspondinp: major status is 
expected and information describing; that 
major status will appear in the status 
interpretation table. 

status entry maj , (description) 

This macro sets up the major status description. 

maj is the major status beins; described. Note 

that this number is decimal. 

description is a character string describing this major 
status. 

substat .entry maj , control , flags , (description) 

This macro sets up infomation for substatus. 

maj is the major status for which this substatus 

applies. Note that this number is decimal. 

control is 6 characters controlling the examination 
of the substatus as described above. 
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flags 



description 
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are the 18 bits of action flags described 
above. This nufiber is octal. It nay also be 
described symbolically. 



is a character 
substatus . 



string describinT 



this 
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Appendix 

The mexp macro definitions are f^iven below for reference: 



" Macro definitions for peripheral status table (veneration, 
'- created 12/1/7^ by Noel I. Morris 



Srinacro s.tatus_table 

name &1_status_table 
ses^def &1 status table 



bool 
bool 



backup, MnOOOO 
initiate, 200000 



retry previous operaticr 
set backup flap: if initiate 



&1__status_table 

&(2 

ifend 



ifend 
&) 

&(2 

ifend 
i) 

'iend 



ife 
zero 



me 
zero 



ine 
set 



?xi,0 
0,0 

&i,0 
m&x ,lm&x 



4i,0 
lmc'^x,0 



'i-nacro 
iend 



status._entry 

aci • "&2",2i4 



■'c")acro substat__entry 

set In^l ,ln<?r1 + 1 

aci "&2'',6 

vfd 18/&3 



aci 



'&n" ,32 



iend 
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Ex am ple 

The following is an example of a status interpretation table 
for the card reader-: 



" CRZ.,5TATUS_TABLE - Status Tables for the Card Reader. 
" coded 12/1/74 by Noel 1. Morris 



" * * 

'■ * Copyright (c) 1972 by Massachusetts Institute of » 

* TeGhnolop:y and Honeywell Information Systems, Inc. * 

,1 * , S 



&inolude status table 



status.. table crz,(1 ,1,1,0,1 ,-0,0,0,0, 1,1,0,1,0,0) 



status__entry 1, (Device Busy) 



status.^entry 2, (Device Attention) 

substat_entry 2, OOOOOO, initiate , (Device off line) 

subs.tat_entry 2, XXX0X1 , initiate, 

(Hopper empty or Stacker full) 

substat... entry 2, XXXO IX, initiate ,( Manual Halt) 

substat_entry 2, 0X10XX, initiate, (Feed Alert) 

substat_entry 2, 1X10XX, initiate , (Sneak Feed) 

substat_entry 2, X1X0XX, backup , (Card jam) 

substat_entry 2 , 1X00XX, backup ,( Read Alert) 



status_entry 3, (Device Data Alert) 

substat._entry 3,000001 , backup , 

(Transfer timing error) 
substat_entry 3 , 000X10, backup ,( Validity check) 
substat^entry 3 , 0001X0, backup , (Dual read alert) 
substat_entry 3, 001000, backup , (Feed without read) 



status_entry 5, (Command Reject) 
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3ubstat_entry 
3ubstat_entry 

substat__entry 



5,0000X1 , backup , (Invalid op code) 

5, 00001X, backup , 

(Invalid device code) 

5, 000 100, backup, (IDCW oarity error" 



status_entry 

substat_entry 
substat_entry 
substat_entry 

substat entry 



10,(MPC Attention) 

10, 000001, initiate, (lAI error) 

10, 000010, initiate, (DAI error) 

10, 000100, initiate, 

(DA Transfer error) 

10, 00 1000, initiate^ (Invalid Punch) 



status.^entry 
substat_entry 
substat entrv 



11, (MPC Data Alert) 

1 1,000001 , backup, 
(Transmission parity error) 
1 1 ,000101 .backup, (DAI error) 



status__entry 
substat ..entry 
substat.__cntry 
substat_entry 



13, (MPC Command Reject) 
13,000001 , backup, 

13, 000010, backup, 

(Illejxal loR:ical channel) 

13, 00 1000, backup . (Device reserved) 



end 



